home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / games / nhak_src.zip / SUPUTILS.OVL < prev    next >
Text File  |  1993-03-16  |  4KB  |  88 lines
  1.              PC NetHack Support Utilities
  2.              ============================
  3.                Last revision: 1990June01
  4.  
  5. This file contains documentation for the NetHack MS-DOS support
  6. utilities SPLITF.EXE and EXESMURF.EXE.  These utilities are provided for
  7. your use to:
  8.     SPLITF.EXE   - Split large files into smaller files.
  9.     EXESMURF.EXE - Modify the runtime parameters of an EXE file.
  10.                (see below).
  11.  
  12.  
  13. 1.  SPLITF
  14. ----------
  15.  
  16. splitf FILENAME.EXT [N]
  17. splitf FILENAME.EXT /r
  18.  
  19. Splitf is a programme for splitting and recombining binary files so
  20. that they can be, if necessary, transferred between computers on
  21. multiple low-capacity floppies.
  22.  
  23. This utility is included because we have our doubts about the success all
  24. versions of DOS have with the "copy /b file1 file2 > file3" command.
  25.  
  26. In order to split a file into several pieces, use the command
  27.     splitf FILENAME.EXT N
  28. where
  29.     FILENAME.EXT - is the name of the file you wish to split.
  30. and
  31.     N - is the size (in bytes) of the pieces you would like to result.
  32.             If you omit N the file will be split into roughly two equal parts.
  33.  
  34. The resulting files will be named in order, FILENAME.000,
  35. FILENAME.001, and so forth (depending on the original FILENAME).
  36. Since this convention loses the original extension, care must be
  37. exercised when splitting multiple files with the same base name.
  38.  
  39. To reassemble a series of files into their original form, use the
  40. command
  41.     splitf FILENAME.EXT /r
  42. where
  43.     FILENAME.EXT is the name of the file to be reconstituted.
  44.  
  45. Splitf will look for a series of files with names FILENAME.000,
  46. FILENAME.001 and so forth, and will continue combining them until the
  47. next sequential file is not found.
  48.  
  49. Be aware that NO consistency checking is performed by splitf; if the files
  50. that are found by this process are NOT the files that were originally
  51. produced by splitf in the correct order, the result will be almost certain
  52. gibberish.
  53.  
  54.  
  55. 2. EXESMURF
  56. -----------
  57. exesmurf FILENAME[.EXT] /v
  58. exesmurf FILENAME[.EXT] /minN
  59. exesmurf FILENAME[.EXT] /maxN
  60. exesmurf FILENAME[.EXT] /stackN
  61.  
  62. The programme exesmurf is essentially a reimplementation of Microsoft's
  63. EXEMOD utility.  However, this incarnation is one that is "overlay-aware"
  64. (as they say).  It will provide the user with information about the executable
  65. and its overlays, and allow you to modify the executable's parameters.
  66.  
  67. This program is made available for all users who were not graced with a
  68. release of EXEMOD in their Microsoft product.
  69.  
  70. /v.
  71. If exesmurf is invoked with a filename as argument, optionally followed
  72. by a /v, the filename's exeheader is listed for your viewing pleasure, along
  73. with the headers of any Microsoft-format overlays the file may contain.
  74.  
  75. /minN, /maxN, /stackN.
  76. Exesmurf may also be used to modify the "minalloc", "maxalloc" and "stack"
  77. allocation parameters of the executable file.  This can be accomplished with
  78. the /min, /max, and /stack flags respectively.  Any aguments to these flags
  79. should be *immediately* followed by a decimal number N.  Note that this is
  80. inconsistant with the agruments to EXEMOD which takes hex numbers, and *needs*
  81. a space between the flag and the number.
  82.  
  83. Whenever exesmurf is invoked, the extension .EXE is assumed for the file
  84. if no extension is given.
  85. ----------------------------------------------------------------------
  86. Stephen P Spackman                           stephen@tira.uchicago.edu
  87. ----------------------------------------------------------------------
  88.